package org.nnxy.foodboot.mapper;

import org.apache.ibatis.annotations.Mapper;
import org.apache.ibatis.annotations.Param;
import org.springframework.stereotype.Repository;

import java.time.LocalDateTime;
import java.util.List;
import java.util.Map;

/**
 * 数据统计Mapper接口
 * 提供各类统计查询的数据库操作方法
 */
@Mapper
@Repository
public interface StatisticsMapper {

    /**
     * 根据口味统计食谱数量
     * @return 口味-数量映射列表，每项包含name和value字段
     */
    List<Map<String, Object>> countRecipeByFlavor();
    
    /**
     * 根据技巧统计食谱数量
     * @return 技巧-数量映射列表，每项包含name和value字段
     */
    List<Map<String, Object>> countRecipeByTechnique();
    
    /**
     * 根据难度统计食谱数量
     * @return 难度-数量映射列表，每项包含name和value字段
     */
    List<Map<String, Object>> countRecipeByDifficulty();
    
    /**
     * 根据时间范围统计食谱创建数量
     * @param startTime 开始时间
     * @param endTime 结束时间
     * @return 食谱数量
     */
    Long countRecipeByTimeRange(@Param("startTime") LocalDateTime startTime, 
                               @Param("endTime") LocalDateTime endTime);
    
    /**
     * 统计总食谱数量
     * @return 食谱总数
     */
    Long countTotalRecipes();
    
    /**
     * 统计浏览量最高的食谱
     * @param limit 限制数量
     * @return 食谱列表，包含id、name、image_url、view_count字段
     */
    List<Map<String, Object>> getMostViewedRecipes(@Param("limit") Integer limit);
    
    /**
     * 统计收藏最多的食谱
     * @param limit 限制数量
     * @return 食谱列表，包含id、name、image_url、favorite_count字段
     */
    List<Map<String, Object>> getMostFavoritedRecipes(@Param("limit") Integer limit);
    
    /**
     * 统计评分最高的食谱
     * @param limit 限制数量
     * @return 食谱列表，包含id、name、image_url、avg_rating、rating_count字段
     */
    List<Map<String, Object>> getHighestRatedRecipes(@Param("limit") Integer limit);
    
    /**
     * 统计总浏览量
     * @return 浏览总量
     */
    Long getTotalBrowseCount();
    
    /**
     * 统计指定时间范围内的浏览数量
     * @param startTime 开始时间
     * @param endTime 结束时间
     * @return 浏览数量
     */
    Long countBrowseByTimeRange(@Param("startTime") LocalDateTime startTime, 
                               @Param("endTime") LocalDateTime endTime);
    
    /**
     * 统计指定时间范围内的收藏数量
     * @param startTime 开始时间
     * @param endTime 结束时间
     * @return 收藏数量
     */
    Long countFavoriteByTimeRange(@Param("startTime") LocalDateTime startTime, 
                                 @Param("endTime") LocalDateTime endTime);
    
    /**
     * 统计指定时间范围内的推荐记录和点击数量
     * @param startTime 开始时间
     * @param endTime 结束时间
     * @return 包含total和clicked字段的Map
     */
    Map<String, Object> countRecommendationByTimeRange(@Param("startTime") LocalDateTime startTime,
                                                      @Param("endTime") LocalDateTime endTime);
    
    /**
     * 根据食谱ID获取食谱详情
     * @param recipeId 食谱ID
     * @return 食谱详情
     */
    Map<String, Object> getRecipeById(@Param("recipeId") Long recipeId);
    
    /**
     * 获取最近添加的食谱
     * @param limit 限制数量
     * @return 食谱列表
     */
    List<Map<String, Object>> getRecentAddedRecipes(@Param("limit") Integer limit);
    
    /**
     * 按月统计食谱创建数量
     * @param year 年份
     * @return 月度统计数据
     */
    List<Map<String, Object>> countRecipeByMonth(@Param("year") Integer year);
    
    /**
     * 统计各分类的食谱数量
     * @return 分类-数量映射列表
     */
    List<Map<String, Object>> countRecipeByCategory();
} 